Skip to main content

Premium Bank Account Verification

Premium Bank Account Verificationโ€‹

Confirms a Nigerian bank account against the premium data source.

POST /api/v1/id-verifications/identity/ng/premium-bav

Authenticate with your API key (x-api-key) or a bearer token.

Requires the KYC_NG_VERIFY and KYC_RESULT_VIEW permissions.

Request bodyโ€‹

NameTypeDescription
accountNumber*StringThe account number.
bankCode*StringBank code from Premium Bank List.
isSubjectConsent*BooleanConfirms the subject consented to the check. Must be true. Rejected before the provider is called, so a false costs you nothing.

Fields marked * are required.

Exampleโ€‹

Request
{
"accountNumber": "2057664202",
"bankCode": "033",
"isSubjectConsent": true
}
Response example coming

Every identity check returns the same envelope โ€” status, data.status (found or not_found), and the fields specific to this check. We have not yet captured a live response for this endpoint: the provider's upstream source was unavailable throughout our verification run, so rather than publish an invented payload we have left it out. The request contract above is confirmed correct.